Skip to main content
Version: Latest

Generar de orden de compra

Se realiza el proceso de generacion de órdenes de compras

Request 🚀​

url​

https://app.aveonline.co/api/nal/v2.0/ordendeCompra.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "generarorden"
  • token* String Token recibido en la Autenticación con vigencia de una hora
  • idempresa* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación
  • idagente* Number Identificador del agente [agentes/listadoagentes]
  • idproveedor* Number Identificador del proveedor [ordenesdecompra/listado de proveedores]
  • ordencompra* String Número de orden de compra,
  • idtransportador Number Código del transportador [nacional/listado de transportadores],
  • modoenvio Number Forma de generar envio: 1=por tiempo, 2=por costo ,
  • detalle* Array Object -> [{}]
    • pedido* String Número del pedido
    • fecha_min Date Fecha mínima despacho orden de compra (DD/MM/AAAA)
    • fecha_max Date Fecha máxima despacho orden de compra (DD/MM/AAAA)
    • plu* String Código interno de la orden de compra por cliente
    • ean* Number Código ean del producto
    • referencia* String Código referencia del producto
    • nombre_articulo* String Nombre del producto
    • descripcion String Descripción del producto
    • cantidad_solicitada* String Cantidad del producto
    • precio* Number Valor unitario del producto (sin puntos ni decimales)
    • total* Number Valor total del producto (sin puntos ni decimales)
    • valoracion* Number Valoración total del pedido(sin puntos ni decimales)
    • cliente* String Cliente destino
    • puntoventa String Punto de venta asociado
    • ciudad* String Ciudad destino (sin tildes ni ñ) [nacional/listado de ciudades]
    • departamento* String Departamento destino (sin tildes ni ñ) [nacional/listado de ciudades]
    • direccion* String Dirección destino
    • tel* String Teléfono destino
    • correo* String Correo electrónico destino
    • observaciones* String Observaciones pedido
    • peso* Number Peso en kilogramos del pedido (sin puntos ni decimales)
    • alto Number Dimensión alto en cms
    • largo Number Dimensión largo en cms
    • ancho Number Dimensión ancho alto en cms
    • cartaporte Number Código cartaporte (0 o 1)
    • campana String Nombre campaña asociada
    • guia String Número de envío predeterminado
    • factura String Número de factura asociada al pedido
    • fecha_redencion Date Fecha estimada de redención (DD/MM/AAAA)
    • codigo_dane* String código dane ciudades (8 posiciones) [nacional /listado de ciudades]

Ejemplo​

{
    "tipo":"generarorden",
    "token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjo3MzAyMzQwLCJleHAiOjE2Njk5MTM0MDksImFwcm9iYWRvcyI6WzYwNzddfQ.iZs8MNMNarSYBjwUDHvLx7rJPGmtTSrdKiB8Qo9-nfg",
    "idempresa": 6077,
    "idagente":"1055",
    "idproveedor": "",
    "ordencompra":"462657",
    "detalle" : [
        {
            "pedido": "1234556789",
            "fecha_min": "2022/12/01",
            "fecha_max": "2022/12/12",
            "plu": "48455", 
            "ean": "",
            "referencia": "7701023387576",
            "nombre_articulo": "VAPORIZADOR ALIMENTOS KALLEY K-VA800N3 BLANCO",
            "descripcion": "",
            "cantidad_solicitada": "1",
            "precio": "123653",
            "total": "123653",
            "valoracion": "115000",
            "cliente": "Jesus Ballesteros Jesus Francisco  Ballesteros Gomez Evelin Yaneth Rincon ochoa", 
            "puntoventa": "",
            "ciudad": "La Jagua De Ibirico", 
            "departamento": "Cesar",
            "direccion": "Transversal 14 # 7 - 37 Barrio Juan Ramon Casa. Casa de dos pisos",
            "tel": "3135215101",
            "correo": "envios@correo.com",
            "observaciones": "7701023387576_VAPORIZADOR ALIMENTOS KALLEY K-VA800N3 BLANCO",
            "peso": "8",
            "alto": "10",
            "largo": "20",
            "ancho": "30",
            "cartaporte": "",
            "campana": "",
            "guia": "",
            "factura": "",
            "fecha_redencion": "2022/12/15",
            "codigo_dane": "08001000"
        }
    ]
}

Response 📄​

Success​

  • status String Estado del resultado
  • message String Mensaje de respuesta
    • codigo Array Object -> [{}]
      • id String Posición de lectura de cada linea
      • text String Linea de respuesta de cada linea

Ejemplo​

{
  "status": "ok",
  "message": "OC 0000 generada con exito",
    "codigo": [
      {
      "id": "Leyendo linea 1",
      "text": "Linea 1 pedido 0000 Generado",
      }
    ]
}

Error​

Existencia de OC​

{
  "status": "error",
  "message": "LA OC ya se encuentra asociada",
  "codigo": []
}

Faltan parametros​

{
  "status": "error",
  "message": "Faltan parametros",
  "codigo": []
}

Credenciales incorrectas o token expirado​

{
  "status": "error",
  "message": "credenciales incorrectas",
  "codigo": []
}

No se encuentran datos asociados​

{
  "status": "error",
  "message": "se produjo un error al momento de iniciar la comunicacion",
  "codigo": []
}